home *** CD-ROM | disk | FTP | other *** search
/ STraTOS 1997 April & May / STraTOS 1 - 1997 April & May.iso / CD01 / ARCHIVER / MPACK15 / MUNPACK.MAN < prev    next >
Encoding:
Text File  |  1996-12-16  |  4.0 KB  |  92 lines
  1.  
  2.  
  3.  
  4. MUNPACK(1)          UNIX Programmer's Manual           MUNPACK(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      munpack - unpack messages in MIME or split-uuencode format
  10.  
  11. SYNOPSIS
  12.      munpack [ -f ] [ -q ] [ -t ] [ -C directory ] [ filename ... ]
  13.  
  14. DESCRIPTION
  15.      The munpack program reads each RFC-822 message `filename' and 
  16.      writes all non-text MIME parts or split-uuencoded files as files.
  17.      If no filename argument is given, munpack reads from standard 
  18.      input.
  19.      If the message suggests a file name to use for the imbedded part, 
  20.      that name is cleaned of potential problem characters and used for 
  21.      the output file.  If the suggested filename includes 
  22.      subdirectories, they will be created as necessary.
  23.      If the message does not suggest a file name, the names "part1", 
  24.      "part2", etc are used in sequence.
  25.      If the imbedded part was preceded with textual information, that 
  26.      information is also written to a file.  The file is named the 
  27.      same as the imbedded part, with any filename extension replaced 
  28.      with ".desc".
  29.      The munpack program reads each RFC-822 message filename and 
  30.      writes all non-text MIME parts or split-uuencoded files as
  31.      files.  If no filename argument is given, munpack reads from
  32.      standard input.
  33.  
  34. OPTIONS
  35.      -f   Force overwriting of existing files.  If a message sug-
  36.           gests a file name of an existing file, the file will be
  37.           overwritten.  Without this flag, munpack appends ".1",
  38.           ".2", etc to find a nonexistent file.
  39.  
  40.      -C directory
  41.           Change the current directory to directory before read-
  42.           ing any files.  This is useful when invoking munpack
  43.           from a mail or news reader.
  44.  
  45.      -q   Be quiet. Supresses messages about saving partial messages 
  46.           and aboutmessages with no interesting information.
  47.           Also write the text MIME parts of multipart messages as 
  48.           files.  By default, text parts that do not have a filename 
  49.           parameter do not get unpacked.  This option effectively 
  50.           disables the ".desc" file feature for MIME messages.
  51.  
  52. DECODING MIME
  53.      To decode a MIME message, first save it to a text file.  If 
  54.      possible, save it with all headers included. Munpack can decode 
  55.      some MIME files when the headers are missing or incomplete, other 
  56.      files it cannot decode without having the information in the 
  57.      headers.  In general, messages which have a statement at the 
  58.      beginning that they are in MIME format can be decoded without the 
  59.      headers.  Messages which have been split into multiple parts 
  60.      generally require all headers in order to be reassembled and 
  61.      decoded.
  62.      Some LAN-based mail systems and some mail providers (including 
  63.      America Online, as of the writing of this document) place the 
  64.      mail headers at the bottom of the message, instead of at the top 
  65.      of the message.  If you are having problems decoding a MIME 
  66.      message on such a system, you need to convert the mail back into 
  67.      the standard format by removing the system's nonstandard headers 
  68.      and moving the standard Internet headers at the top of the 
  69.      message (separated from the message body with a blank line).
  70.      There must be exactly one message per file. Munpack cannot deal 
  71.      with multiple messages in a single file, to decode things 
  72.      correctly it must know when one message ends and the next one 
  73.      begins.
  74.      To decode a message, run the command:
  75.      
  76.           munpack " file"
  77.  
  78.      where "file" is the name of the file containing the message. More 
  79.      than one filename may be specified, munpack will try to decode 
  80.      the message in each file.  For more information on ways to run 
  81.      munpack, see the section "OPTIONS" above.
  82.  
  83. ENVIRONMENT
  84.      TMPDIR
  85.           Directory to store temporary files.  Default is /usr/tmp.
  86.  
  87. FILES
  88.      $TMPDIR/m-prts-$USER/
  89.           Directory used to store partial messages awaiting
  90.           reassembly.
  91.  
  92.